JSDoc + .d.tsでよくね?
綾坂こと.icon
そこで自動生成ドキュメントに型を認識させるために.d.tsが必要だったので書いたらこれが思ったより良かった ので、JSDoc + d.tsがいいのではという気持ちになってきている
やっぱりコード中に型を書く理由はわからない
code:script.ts
const add = (a: number, b: number): number => a + b;
↑なんでこんなところにnumberを書いちゃうんですか
code:ts
// script.js
const add = (a, b) => a + b;
// declare.d.ts
declare const add: (a: number, b: number) => number;
↑ロジックと型が分離されている方が見やすい……と私は思っている
なんとかなってほしいところはまだある
.(m)jsから.d.tsを読む設定の方法が統一されていない
逆にd.tsに型以外の情報を書きたくない
JSR、JSDocとd.tsの両方がある場合はd.tsしか見ないっぽくてd.tsにJSDocを書く羽目になっている d.tsには型だけ書かせてくれよ
いっそロジック・型・説明をそれぞれ分離するのがいいのでは?